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THIS IS HOT Z-2068 


HOT Z-2068 combines a line-by-line assembler, a labelling disassembler, a single-stepper and a 
simple editor. The purpose of HOT Z is to give you a reasonable degree of direct control of your 
computer, as well as to assist you in writing assembly-language programs to extend your control. 


The enclosed tape holds four copies of HOT Z-2068. Two of them have a full NAME file that 
annotates most of HOT Z. Two of the versions are in fairly low RAM, near to BASIC, and two 
are in high RAM. The loading format is simple and leaves HOT Z completely open and in your 
hands as a standard CODE-format tape. You should therefore be able to move it to wafer drive, 
disk, PROM, or whatever goodies might appear beyond the grave of TS computerdom. For 
EPROMs, only the code above C000 should be burned in. Variables are initialized automatically, 
but NAME files would have to be tape-loaded according to taste. 


The high memory version is compatible with use of both display files if 64-column or extended- 
color software becomes available. The low- memory version cannot be used with a BASIC pro- 
gram, but it does give you access to memory occupied by the high-memory version. 


Use LOAD or LOAD "HOT Z" to start. The load is double, first a short BASIC routine that can 
be used to reSAVE HOT Z and which automatically proceeds to LOAD the HOT Z code. HOT Z 
comes up running, but you can switch to BASIC with the symbl-shift Q command (SS-Q) and 
work out the details of loading or saving it from the short BASIC routine. The BASIC is for 
loading convenience only and is in no way necessary for running HOT Z-RAMTOP is set so that 
you can use NEW in BASIC without destroying HOT Z. You can change the setting of RAMTOP 
by just writing to that variable with HOT Z. 


The second copy on each side of the tape consists of the same version with a short NAME (label) 
file. To get access to it, LOAD the first copy, stop the tape, return to BASIC with symbol-shift Q, 
and LOAD again. Then make a copy on your own tape for everyday use. The labels will be 
referred to extensively in the notes because various relocations of HOT Z may exist, and the labels 
are the only common ground, but for practical purposes you will probably want to do without 
them. 


The high-memory version of HOT Z will cohabit with a BASIC program, although BASIC is a 
foreign language to HOT Z and must be read as data when HOT Z is in command. HOT Z-2068 
sets RAMTOP to protect itself from a NEW command in BASIC. The setting occurs during ini- 
tialization (STAR) and can be altered to suit your needs. 


HOT Z requires some knowledge of the hexa-decimal (hex) number system, which uses the char- 
acters 0-9 and A-F as its 16 digits. These instructions were written with the assumption that you 
know the fundamentals of Z80 machine code, for which there arc numerous books on the market. 
If you are learning, then use HOT Z as a blackboard to work out the exercises. 
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MEMORY MAP 


Brief memory maps of the versions of HOT Z-2068 on your tape are as follows: 


v.1.61 1.62 v et Gt Mm 1.72 
NAMES AADA  EC02 CODE 6C00 6C00 
VARIABLES EF70 BF70 DATA 99A0 99A0 
CODE C000 C000 JUMPS AOFO AOFO 
DATA FILES EDAO EDAO VARS A320 A320 
JUMP TABLES F4F0 F4F0O NAMES A518* AS5A4 
END PEPE F71F END B9AE A8FF 


(* Subject to updating. Check with CSS-T) 


Note that even the related versions are of different length. Version 1.61 has a full label file and a 
set of prompt screens that extend it all the way to the top of RAM. It is helpful if you are studying 
code and learning HOT Z, but in many cases you might want to work with less baggage and more 
workspace of your own. Version 1.62 gives you a short label file of system variables and leaves 
you workspace above and below. Version 1.71 differs from 1.72 in having a large label file, which 
extends it higher in RAM. These are intended mainly for disassembling programs that occupy 
high RAM. 


RUNNING HOT Z 2068 


The following section provides an introductory tour of HOT Z. The experienced and the adven- 
turous among you will want to plunge right in. If so, arm yourself with the short command lists 
and the keyboard map and try your luck. Details of the various commands are available in the later 
sections of these notes. Any references to specific addresses will refer to the high-memory 
version. 
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AN INTRODUCTORY TOUR 


HOT Z-2068 will come up showing the first screen "page" of disassembled ROM. Down the left 
side of the screen, you will see the memory-address column, to which everything in HOT Z is 
keyed. These addresses are in hexa-decimal and in the format accepted as input by the program. 
In other words, all addresses are four hex digits and include leading zeroes but no identifying 
symbols either before or after. The format is always there for you to consult as you make entries 
to HOT Z. Addresses run from 0000 to FFFF. 


The second column of the disassembly display lists the contents of each memory byte again in 
hexa-decimal, two digits per byte, packed together with no spaces between. These numbers occur 
strictly in the order they occur in memory, which is not necessarily an easy order for reading. This 
column is raw data, as it were, against which any "interpretation" can be checked. Z80 instructions 
can be from one to four bytes in length. A HOT Z routine gets the length of any instruction and 
parses the bytes into instruction length clusters, but it cannot decide whether those bytes hold true 
Z80 code, as here, or simply numbers used as data. That decision in the end is up to the reader. 
On this first page of ROM, the first two instructions are one byte long, the third three, etc. 


The next column, the NAME column, will hold user-entered labels for the corresponding address, 
along with a few labels provided in a permanent file on your original tape. After you have anno- 
tated a program with these labels you can SAVE a NAME file separately from HOT Z, to be 
loaded again with whatever program the labels pertain to. 


The fourth column presents those particles of electronic poetry known as assembly mnemonics. 
Relative jumps (JR’s) are listed, as in the sixth line, with their destination address (or NAME) 
rather than the single displacement byte with which they are coded. System variables for the ROM 
are listed by an abbreviated name as in lines 4 and 5. 


The first four instructions turn off the keyboard interrupt, set A to zero load DE to count 64K of 
memory, and jump to the initial initialization routine. The rest of the screen is taken up by RST 
routines. RST 10 prints the character whose code is in A, RST 08 handles BASIC error reports. 
RST 18 and 20 help with interpreting BASIC, and RST 28 is the entry to floating-point operations, 
which are a separate sub-language in the 2068. RST 08 and 28 are always followed by one or more 
(for 28) bytes that serve as data rather than as machine code. The meaning of such bytes is listed 
in the mnemonics column if you have the floating-point interpreter switched on. 


The current HOT Z display is referred to in these notes as READ mode or disassembly. The 
commands in this mode are mainly for moving the display around to give access to different parts 
of memory. The page flip, for example, is the SPACE bar, hit it to continue the disassembly with 
the instruction following the one at the bottom of the screen. For distant moves, you can enter a 
four-digit hex address to the ADDR cursor at the upper-left screen corner. For example, try 0D31 
to see the initialization routine. 


During address entry, you can backspace to correct an error by using the DELETE key which will 
back up the cursor one space. DELETE doesn’t blank out the entry and that you can’t back out of 
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the whole entry routine that way. To back out, use the ENTER key, which works as an escape key 
in this situation. You must type in all four hex digits of an address or all four characters of a 
NAME (label). ENTER is not needed after the last hex address digit. 


The keyboard with HOT Z-2068 responds almost identically to the way it responds in BASIC. 
HOT Z gives a different tone feedback (You can alter that by changing pip_), and gives the tone 
for CAPS LOCK and the SYMBOL-SHIFT/CAPS-SHIFT (CSS) combination as well. CAPS 
LOCK is initially set. Lower-case a through f are not recognized as hex digits, so if you shift to 
lower case to enter a label, be sure to shift back before entering hex or Z80 mnemonics. The 
lower-case mode is indicated by cursor flashing and bright rather than just flashing. All the shift- 
key entry combinations are the same as in BASIC except that the K-cursor state is not used by 
HOT Z, so the keyword legends on the keys themselves are not available. 


In READ mode, you can also get to a named routine by entering the four letters of an assigned 
NAME. Try KEYB. You will see that the NAMEs appear in both the NAME column (referring 
to the current address) and in the mnemonics column (referring to the target address of CALLS or 
jumps). 


In general, you can use a NAME in the file as a proxy for its address in the READ, Assembly, Edit, 
or One-Step modes of operation. 


If you did not do so before loading, set the screen to your favorite color combination using the 
BORDER (on CSS-SS-BORDER, i.e. the BRIGHT key), PAPER and INK commands. They 
work essential as in BASIC except that the color comes up right away. 


Try keying SS-G (THEN) from READ mode. This is the display switch. and successive strokes 
of the same key will take you back and forth between the data and the disassembly displays. The 
data display is for examining those parts of memory that are used as files of data rather than for 
Z80 code. The first and second columns contain the single address and its content in hex, values 
that are reflected in decimal in columns four and five, (Use it as a conversion table). The far-right 
column gives the CHR$ of the contents of the address and will turn up any BASIC programming 
or message files. Enter, for example, the address 0227 to see the keyboard file. Switch back to 
disassembly while you’re still looking at the keyboard file for a taste of what disassembled data 
(sometimes called nonsense) looks like. It’s up to you to distinguish sense from nonsense when 
reading a strange program; the display switch is there to help you do it. 


The NAME column in the data display functions differently from the column with the same head- 
ing in the disassembly. The NAMEs in the data display are those that correspond to any two 
successive bytes, taken in lo-hi order, in the second column. (The disassembly displays NAMEs 
assigned to the addresses in the first column). Some NAMESs in the data display can crop up by 
chance; for example, two NAMEs immediately together mean that at least one is spurious. 


Use the CSS-T command in READ mode to go to the beginning of the NAME file. The NAME 
file grows downward like a stack, which it is not, as you add new NAMEs to memory addresses. 
Turn on the data display to see the structure of the NAME file. Each NAME takes six bytes; the 
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first two hold the address to which the NAME is assigned, hence the listing in the NAME column, 
and the next four hold the NAME itself, which shows in the CHR$ column. Other odd CHR$ 
symbols will appear at random for some of the address bytes, signifying nothing. 


The data display is also useful for looking at BASIC programs to see the real structure of BASIC 
code. 


You can enter decimal addresses to the ADDR cursor, but these must be prefixed by the OR 
(SS-U) command. Try it, and check the conversion with the data display. If you enter a decimal 
address of less than five digits, then you have to press ENTER to tell HOT Z that you’ve finished. 
If you enter a decimal higher than 64K, the program will subtract 64K and give you what’s left. 


Now get into disassembly and go to 3B2E, which is where the ROM begins the BASIC function 
LN. Hit CSS-O (PEEK) to turn on the floating-point interpreter. The first instruction after the 
RST 26 restacks the number on the top of the calculator stack in full five- bytes form (in case it is 
a short integer); the number is then duplicated on the stack and tested for being positive non-zero; 
if it is, a jump is made to 3637; otherwise, execution proceeds to end the floating-point code and 
fall into the trap for error A. At 3B37, we have an example of floating point code that is embedded 
and not preceded by an RST 28 because of the jump. To get the correct interpretation, enter 3B37 
to the ADDR cursor, then use the switch command on the CSS-I (CODE) key. 


At 3B35 you will see a rendition of a BASIC error report after RST 08, in this case for a zero or 
negative argument to the logarithm. Occasionally, you will encounter a CF as data rather than RST 
08, in which case the error number may be invalid and left blank. 


The last display on the tour is the Z80 register display or Single- Stepper. It is one of the quirks of 
bi-linguality that this display must be entered from an area where the floating point interpreter is 
not switched on, so first enter an address above 4000, say. Then use the STEP (SS-D) command 
from the disassembly. 


The register display occupies the top three quarters of the screen. The left column lists the various 
Z80 registers; please refer to a good Z80 reference book if you need an explanation of the register 
names. The exchange flags are listed as EXFLAGS. 


The second column lists the hex values of the registers’ contents. Values for the accumulator (A) 
are listed at the left of the column to remind you that A is the high half of the AF register pair, 
along with H, D and E. The third column either converts the second column value to signed- 
decimal according to the two’s complement convention, or, if the second column holds an address 
that has been NAMEd, then that NAME is listed in the third column. The fourth column, headed 
by the open parentheses, gives the hex value of the byte contained in the address formed by the 
register-pair values (e.g., across from HL you will find the byte (HL).) The right column gives the 
CHR$ of the byte in the fourth column (for the register pairs) or of the byte in A. 
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The box below the one containing the exchange registers holds details on the one-step user’s stack 
and the state of the flags registers. The user’s stack is separate from the main machine stack so that 
the system can absorb a few stack errors without crashing the program. The top four pairs of bytes 
on the user’s stack are shown at the right, along with the NAMEs for any addresses they might 
hold, so that you can check to see whether your test routines leave anything behind. The main 
flags are listed below the exchange flags for easier visual association with the conditionals in the 
program steps below. Standard conditional mnemonics are given for the four programmers’ bits. 


The cursor at the left in line 18 (which is bright) marks the address of the next step set up to be 
executed by the single- stepper. You can enter any address into that cursor just as you could in 
READ mode, or you may also use a NAME. The ENTER key still serves as an escape during 
address or NAME entry, but it has another more important function as well, which is to run the 
next single step. 


If it’s not already there, enter 053A to the NEXT slot, and then notice the contents of the A and C 
registers just before and after you press the ENTER. This is a fairly safe area and you can exper-. 
iment with a few more steps. (The things you must be careful about are loading into some system 
variables, either ROM’s or HOT Z’s, and some flag Sets. The SPACE key allows you to skip the 
step at NEXT. The top line of Z80 instructions represents the previous step executed, and the three 
steps following the one in NEXT are those that will be reached if there is no branching. A 
branched-to step appears directly in the NEXT slot, a skipped step disappears from the display. 


For faster debugging, you can set breakpoints (AT and OR commands) and use the SS-G (THEN) 
command to step through the code as far as the first breakpoint encountered. Two breakpoints are 
provided so that your can cover both sides of a conditional branch. You must take care to set 
breakpoint addresses that the code will actually encounter. Since stopping depends on finding a 
breakpoint exactly. The BREAK key will stop the CSS-G command if used quickly enough. You 
can display the current breakpoints with the SS-Y (AND) command. 


Breakpoints are only checked for in your main code line, not during any subroutines (CALLs or 
RSTs). This may not be ideal for all your tests, If you want to set breakpoints within your sub- 
routines, then change the RTPB (DOED) routine as follows: the second instruction (DOFO) should 
CALL STEP (CD71D2) and the second last instruction (D10A) should CALL STE2 (CD40D5). 
If you make these changes, then don’t use both the window and code with RST 10s that you run to 
breakpoint. 


Learners might consider mastering the use of the Single-Step first and than using it to see how the 
various instructions and a few resident routines work. A lot of bugs can be avoided by testing 
every routine you write with this device. You can also create a special display screen that will 
show the display of your test routine and alternate with the register display. See the section on the 
Single Step Window for details. 


Hit SS-Q (Quit) to get back to the main READ display. You will arrive at a screen page that starts 
with the address that was in the NEXT slot of the Single-Stepper. If you spot an error coming up 
at the bottom of the Single-Step display, you can quit the display. EDIT the error on the 
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disassembly display, and get back to where you were in the Single-Step by using the STEP com- 
mand from READ mode. 


You can also go directly to assembly mode within the Single Step display to make minor changes 
to upcoming code. The CSS-A key will give you a cursor at the head of the mnemonics column 
and let you make changes without exiting Single Step You are effectively in the edit mode with a 
return address to Single Step on the stack. Consequently, all of the edit commands are available to 
you, but you must make judicious use of them. It would not be wise, for example, to invoke the 
Single Step while editing under the Single Step. 


A number of operations may redo the screen to the EDIT mode or otherwise damage the register 
display. However, the Single Step screen will re-establish itself as soon as you exit the EDIT 
mode by hitting ENTER. 


Operations that move to a different address in edit will not change the currant address in the NEXT 
slot. That will be preserved just as if you had left the Single Step and then come back to it. 
Moving the cursor out of the disassembly area into the register display is usually prevented and not 
advised. 


HELP SCREENS 


Version 1.61, which contains the long NAME list, has been fitted out with three HELP screens. 
They are called from whatever mode you are in with CSS-H (SQR), and any keystroke will then 
remove the screen and restore whatever was there before. Each mode calls up its own command 
list. 


The HELP screens start at F704 (EDIT), FA04 (STEF) and FD00 (READ). You can edit them to 
say what you want them to with the DB "" command or with HEXEDIT, resave, and have your 
own custom prompts. 


The disadvantage of having these screens on line is the memory they take up. This version fills all 
the memory above HOT Z to FFFF, so your workspace is limited to that between about 80 bytes 
above STKEND and the descending edge of the NAME file, as determined with the CSS-T 
command. You can strip the prompt screens off by deadening the CSS-H key for the three modes 
and making a slight change in the BASIC loader. Use the HEXEDIT mode (DATA display and 
EDIT) and the CSS-N command to write DeAD (you need caps lock for the e) at FSAA (STEP) 
and F62C (READ) and to write KRES at F6AE to kill the commands. In BASIC, delete line 9016 
and edit line 9015 to delete the REM so that it becomes an active LET statement. Then RUN to 
make a new tape without the prompt screens. 


To attach the prompt screens to any other version, make a HOT Z tape from F704 to FFFF. Then 
LOAD that tape with the desired version and hook up the three commands. The commands are at 
6CAO (READ), 6CBD (EDIT), 6CE8 (STEP), and the command slots are listed above for version 


Page 7 


1.6 and are at ALAA (STEP), A22C (READ), and A2AE (EDIT) in 1.7. Writing the command 
address to the command slot hooks in the command. 


DISASSEMBLER FEATURES 


The HOT Z disassembler has been specially programed for the Sinclair ROM to take account of 
the system variables, the BASIC error reports, and the floating-point operations, which make up 
the Sinclair ’calculator language’. 


Abbreviations of system variable names are included in the permanent NAME file that loads with 
the program. The HOT Z disassembler always uses the name for a system variable whether it is 
referred to by absolute address (e.g. 5C72) or by a displacement from IY (TY+38). However, if 
you want the IY form from the assembler, you must write it out, since the assembler will always 
substitute an address (two bytes) for an entered NAME. Because the system variable names are 
part of a NAME file, you can change the abbreviations to suit your own taste by entering a new 
NAME over the top of the old one (CSS-N command in EDIT). 


When an RST 08 occurs, the following byte is not Z80 code but is used as data to generate the 
BASIC error report. HOT Z reads these bytes as ERROR 9, etc., rather than generating Z80 
mnemonics for them. If you are running the disassembler over a block of data, you may encounter 
a CF (hex for RST 08) followed by a byte that would be out of the range of the error reports. In 
that case, the error number is not printed. 


An RST 28 is the ZX ROM’s entry into the floating-point language, which can be disassembled by 
HOT Z. You can switch the f-p language interpreter on or off with the CSS-O (PEEK) command 
in READ. The default on start up is off. If you want to know what is going on in the floating-point 
routines, then consult appendix A of these notes. 


WRITING AND EDITING Z80 CODE 


The READ mode is essentially passive, allowing you to page through the memory and examine its 
contents. The WRITE or EDIT modes are there to let you make changes in the memory content, 
provided that memory is RAM. 


There are three WRITE/EDIT modes. With the disassembly display, you can press SS-A (STOP) 
and a cursor will appear at the top line of the edge of the right column. This is the Assembly mode. 
Once you turn on the cursor, you change the entire command system of HOT Z. The commands 
available to you with the cursor on are listed as the EDIT-mode commands on the command lists. 
Hitting ENTER with the cursor in its "home" column will quit the WRITE mode and return you to 
READ, where you can readjust the screen to another part of memory. 
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In addition to the command set, the up and down cursor controls allow you to move the cursor to 
a given line or to scroll the display page one line up or down by moving the cursor up from its top 
position or down from its lowest position. Up scrolling is automatic when you ENTER a line that 
is third from the screen bottom. 


You may also enter a new Z80 instruction to replace the one listed on the cursor line. Just start 
typing and the existing line will disappear, as you type, the delete key and the left and right cursor 
controls will function as you expect them to. If the cursor is over the top of a character, your next 
keystroke will replace that character. If you want to insert a character, press the EDIT key and a 
space will be created at the cursor position, with all characters to the right of the cursor being 
shifted one space right. The right most character in the line (usually a blank) is destroyed by this 
insert command. You cannot jump to another line with the up or down cursor command while you 
are in the middle of editing a given line. 


When you have entered the intended Z80 instruction, hit the ENTER key to put the proper code 
into memory. If your entry is in the proper format, the cursor will return to the left edge of the 
column and move one line down, ready to edit the next line. If the cursor stays put in the line you 
are working on, then it indicates a format error in the mnemonic entry. 


HOT Z follows the format of the mnemonics listed in the Zilog Z80 technical manual. This format 
is the same as that listed with the character set in your computer’s instruction manual, with the 
following exceptions: the RST’s are followed by a hex byte (08, 10, 18, 20, 28, 30, 38) rather than 
decimal and the OUT (N),A and IN A,(N) use the parentheses shown here. (N is always a two- 
digit hex byte). The open parenthesis is always preceded by either a space or a comma, and spaces 
are always important. 


When HOT Z fails to accepts your entry, it locates the line cursor at the first position that does not 
match its template for a proper instruction. Sometimes, however, as with an omitted space or an 
un-assigned label, the cursor may appear earlier than your particular format error. (For example, 
it will flag the first letter of a label even if only the fourth letter is "wrong".) 


If you get stuck and can’t get HOT Z to accept what you’ve entered, you can abandon ship and 
restore the original mnemonic by hitting the semicolon (;). Your recourse then is to look else- 
where in the disassembly for the format of the instruction you have been trying to enter, or to look 
up the hex code for that instruction and to enter that in the hex column (See below) to discover how 
HOT Z lists the mnemonic. 


If you try to back out of a line with the cursor-left key, HOT Z will act as if you have tried to 
ENTER the line. If you write all the way to the end of the line an ENTER will also be automati- 
cally appended. This occurs with some of the IY+N instructions, which just fit in the allotted 
space. 


You can use a preassigned NAME in an instruction anywhere that a 16- bit (four hex digits) 
number occurs. For example, LD HL,(rmtp) is equivalent to LD HL,(SCBZ). You must give a 
NAME to a particular address (CSS-N or INKEYS command in WRITE) before you attempt to 
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use it in an instruction. 

Relative jumps (JRs and DJNZ) are normally entered with the destination address or NAME. 
However, for the JRs only (not DJNZ) a second form is available for short forward jumps where 
you haven’t yet assigned a NAME but know how far forward you want to jump. JR +5 will jump 
ahead over five bytes. The plus sign is required and the displacement is in decimal with a range 
from 0 to 127. Backward jumps are not catered for in this way; it is easier to look back for the 
address you want to get to. 


Provided you do not want one of the last four conditional expressions (M, P, PO, or PE), you can 
use relative jumps all the time, and if the destination address is too far away HOT Z will convert 
your JRs to JPs (absolute jumps) rather than report an error. The reverse is not true: if you enter a 
very short absolute jump, HOT Z will take your word for it. This conversion works well for entry 
of new code, but you must beware when editing in the middle of an existing routine, because if a 
two-byte JR is edited and becomes a three-byte JP, then the first byte of the following instruction 
will be overwritten. 


There is no ORG command because you are doing the ORG yourself with HOT Z. However, 
direct data entry is possible in the assembly-edit mode through use of the DB pseudo-op. DB may 
be followed by a quoted string (DB "ABCDE") or by an even number of hex digits (DB 090F 
OD3A). Spaces are ignored in reading the hex digits, except for the required space after the DE. 
Each pair of hex digits is read as one byte, and a single digit left over will be ignored. You can 
write a string or series of digits all the way to the end of the line. 


When you hit the end, HOT Z will add the quote if necessary and enter the line. Upon entry, the 
editor enters one character (for a string in quotes) or two hex digits per byte starting with the cursor 
address for as many bytes as it takes, then resets the Screen layout so the next cursor address is at 
the top of the screen. The reason for this is that the data you have entered would be disassembled 
by HOT Z, producing a nonsensical listing. You can look back with the data display to assure 
yourself that what you have entered is indeed there. 


The DB is simply a means of entering data without leaving the assembly-edit mode. You should 
still assign NAMEs to your strings or variables and use them in referencing the data. The insert 
command is recommended when you enter data into an existing code block. 


If you want to use the RELOCATE command (described below), then you should not mingle small 
blocks of code and data. Keep them in large blocks and keep track of what is where. 


In addition to string entry with DB, you may also enter quoted non- inverse characters for direct 
eight-bit register loads or for direct arithmetic/logic operations. LD A,"A" will assemble as LD 
A,41 and CP "Z" as CP 5A. Sixteen-bit (double) register loads are not treated in this way. 
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Hex Edit Modes 


Hit the >= key with the disassembly display to get into the main hex edit mode. The "home" 
column for the cursor in this case is between the address and hexcode columns at the left of your 
screen. Cursor controls work as with the assembly editor. 


To change the hex content of memory, you may either move the cursor over with the cursor-right 
key or re-type the line, using the keys from 0 to F. With the disassembly display, each line holds 
the correct number of bytes for a single Z80 instruction. If you write a one-byte instruction, the 
cursor will jump to the next line immediately; for multi-byte instructions, the cursor waits on the 
line until the required number of bytes have been entered, then jumps automatically. 


The purpose of this feature is to allow you to copy hex listings from printouts or magazines. You 
can just type away without worrying about hitting ENTER at every line, and the screen will scroll 
along with your entries. 


With the edit mode, what you see in the hex column is what you get when you make an entry byte 
for byte. Edit does not use NAMEs and you have to calculate the displacements for any relative 
jumps you enter. 


All of the EDIT-mode commands are available with the hex-edit cursor on screen. There is, 
however, no character insert while you are editing a line, and the escape key in the middle of a line 
is ENTER rather than semicolon. If you need to change the first byte of a line after you have 
started editing it, you should escape by hitting ENTER and start over. 


You can hit the SS-G (THEN, display switch) key either before or after you have gone to the 
hex-edit mode in order to obtain the data-edit mode. This mode lets you change one byte at a time 
by writing a new value over the top. This is the mode that you would use for entering hex data 
files, addresses and the like. (Use the DB command from the assembly mode for entering text 
files). All write Commands are available from this mode as well, except the NAME (CSS- N) 
command functions differently than it does with the disassembly display. CSS-N will no longer 
assign a new NAME, but can be used to write a pre-assigned NAME to the NAME column, and 
the address to which that NAME belongs will then appear at the cursor address and the byte 
following. The intended use is for creating address files (jump tables). 


Inserting and Deleting Lines (All EDIT Modes) 


What happens when you press ENTER after writing an instruction is that HOT Z reads the address 
of the line you are working on, looks up the numeric code of the instruction, and enters that code 
into as many bytes as it takes. Then control goes back to the disassembler, which reads back your 
code into Z80 mnemonics and revises the screen page accordingly. An important consequence of 
this is that when you are editing an existing block of code you must be careful not to overwrite 
more lines than you intend to (by entering a four-byte instruction over a two-byte instruction, say) 
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and to watch out for new instructions that crop up when you overwrite a long instruction with a 
short one (one-byte over a three-byte instruction, for example). 


If you don’t know the byte length of Z80 instructions, the way around the above problem is to use 
the line-insert (EDIT) and line- delete (DELETE) commands whenever you are editing an existing 
block of code. 


When you insert or delete a line, a block of code is moved either to make room or to close up the 
empty space. One end of that block of code is determined by the cursor; the other end must be 
determined by you before you start your editing session. Whenever the WRITE cursor is on, a 
variable called END is displayed in the upper right corner of your screen. END marks the other 
end of the active memory block for an insertion or a deletion or indeed for any block operation, 
such as a Clear, fill, SAVE, or a transfer. END is set with the TO key (as in TO the END) followed 
by four hex digits or a NAME. On some types of entry errors, you may be asked twice for the 
proper value. 


You should set END whenever you begin an editing session. END should be within your work- 
space and not overlap with the HOT Z program, lest you move sections of HOT Z around and lose 
control of Your computer. For the insert-line and delete-line commands. A special restriction has 
been added to the value of END. For those operations, END must be within 256 bytes of the cursor 
address, or else you will be asked (automatically) to enter a new value of END when you give the 
insert or delete command. At that point, HOT Z will accept any value you enter for END and 
perform the operation. The purpose of this behavior is to catch those times when you have for- 
gotten to set END, and to save you from a possible crash. 


There are three separate commands to set END, just to make it easy. The TO key will work in 
either EDIT or READ modes, or you can use the OR (SS-I) key in EDIT mode to pass the address 
at the cursor directly to END. END is generally always on screen when you need to know it. 


For insertions and deletions, END can be either above or below the cursor address. The "usual" 
value should be for END to point to an address higher than the cursor address, in which case an 
insertion would push all values to higher addresses to make room for the new instruction. For 
example, if you insert a two-byte instruction at 8C10 with END set to 8C80, then all instructions 
from 8C10 will be moved two bytes higher until 8C7E, which will go into 8C80, and the original 
contents of 8C7F and 8C80 will be destroyed. A deletion of a two-byte instruction would move 
all instructions to lower addresses, and the contents of 8C7F and 8C80 would be duplicated in 
8C7D and 8C7E. 


On the other hand, if the address in END is lower than the cursor address, then an insertion will 
leave the following addresses undisturbed but will push the contents of preceding addresses to 
lower addresses as far as END. For example, with END set to 8C00 and the cursor at 8C10, 
insertion of a three-byte instruction would destroy the contents of 8C00, 8C01 and 8C02 by over- 
writing them with the contents of 8C03, 8C04 and 8C05, respectively. Analogously, a deletion 
would duplicate the first three (or N) bytes in the next three. The insertion itself will in this case 
go into the address preceding the cursor address. This feature is useful when you are editing in a 
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constricted memory block with blanks that may be either above or below. 


After insertions or deletions, the cursor position may have to be adjusted for your next entry. (The 
preceding discussion uses "above" and "below" to refer to numerical values of addresses, not to 
screen position, where addresses get higher as you go down the screen.) 


When a NAME is assigned within a block where you are inserting or deleting lines, the NAME 
will move with the instruction to which it is assigned. The displacement assigned to relative jumps 
is not adjusted, so JR TARG may read JR 8C22 after an insertion that pushes TARG from 8C22 to 
8C23. Be sure and label all JR destinations and then check that the labels are still correct after an 
editing session. An error will stand out clearly if you use labels all the time. 


When you are editing the data display, all insertions and deletions affect one byte at a time. 


Using EDIT Commands 


Many of the EDIT commands affect a block of memory and require that the END variable be set 
first to a proper value. Use the TO key to set it. Aside from its use for insertions and deletions of 
lines, END is generally set to denote the end of a block of code, whereas the cursor marks the 
beginning. If END is less than the cursor address, the block is generally taken to be null, though 
sometimes the operation will still affect the very first byte. Most operations include the END 
address, the exceptions are SAVE and LOAD, which finish one byte before. (This makes it ef- 
fectively impossible to LOAD or SAVE address FFFFH, since the next address is 0000, which is 
less than any cursor address.) 


The block commands are LOAD, SAVE, FIND, TRANSFER, CLEAR, FILL, LLIST, READ- 
DRESS and RELOCATE, in addition to the line insert and delete described above. The simpler 
commands are SS-A and SS-E. which toggle the cursor across the screen between assembly-edit 
and hex-edit, SS-G, which toggles the display between disassembly and data and works only in 
hex-edit because you can’t assemble data; CSS-N and CSS-X, which allow you to assign or delete 
a NAME at the cursor address; STEP, which takes you to the single stepper; and CSS-RUN, which 
transfers control to the program beginning at the cursor (Novices beware!). 


The cassette commands (LOAD, SAVE, and VERIFY) allow you to move the contents of indi- 
vidual blocks of memory to and from tape in the CODE format. Such tapes will be loadable by the 
corresponding BASIC command if you calculate the length (END - cursor address) and work out 
the decimal values. Similarly, CODE-format tapes made in BASIC will load with HOT Z when 
you have made the numeric conversions to hexa-decimal. The BREAK key works to interrupt any 
of the cassette functions. Error reports will appear on screen with a BEEP, and the system will 
wait for a keystroke before accepting any further commands. 


Cassette functions all require tape names, which are entered without quotes after you give the 
command and before you press ENTER. Maximum length for such tape names is the standard 10 


Page 13 


characters. An incorrect loading space (END minus cursor address) for the tape in question wiil 
result in a tape loading error. If you get such an error, you can inspect 5D80 and the following 
addresses with the data display: the length you enter is at SD8B & C, the length read from the tape 
at 5D9C & D. Then correct your setting of END. 


The TRANSFER command allows you to move the contents of one block of memory to another 
block. The first thing to do is to make sure that your destination block will hold the source block 
without overwriting something you want to keep (or HOT Z). You have the option of copying just 
the code with CSS-T (RND) or of copying the code and moving the NAMEs assigned to it as well 
with CSS-SS-T (MERGE). The original of the code will not be erased by this command. You can 
copy from ROM but of course not into it. 


To use the transfer command, set END and hit the appropriate command keys. This will bring up 
a DEST cursor at the upper left, which asks you for the destination address of the block. HOT Z 
will wait for you to hit ENTER after that address, and if you change your mind or find you’ve 
entered it incorrectly you can bail out by hitting the SPACE key instead of ENTER. After the 
command has executed, the display will move to the address you gave to DEST. 


The FIND command has a similar protocol as that of transfer In this case, set the cursor to the 
beginning of a block of memory for which you want to find a match. Set END to the last byte of 
your template. Hit CSS-F (SGN). An address cursor labelled LOOK will come up at the upper left. 
Enter the address at which the search should begin; hit ENTER to proceed or SPACE to back out. 
HOT Z will search 32K (8000H) bytes for a match to the memory from cursor to END. If a match 
is found the display moves to it. If there is no match, the display remains at your template in 
READ mode. If you find one match and want to search for another, set the cursor again, move the 
cursor down a line or two so it doesn’t point to the beginning of the found match, and use the 
CSS-G (ABS) command. If a second match is found, the display will move to it; if not, the display 
stays put. (NOTE: If you are searching for a block of 8 zeroes, say, and you find a block of 12, 
then to of 12, then to continue the search you should move the cursor down so that there are 7 
zero’s or less below it, or else you will find the same string all over again. 


The CLEAR command (ERASE) will put zeroes in all bytes from cursor to END. The FILL 
command first asks you for a keystroke and then fills the block with the code for the character 
assigned to that key. (If you clear or fill a block of HOT Z or the stack, you are likely to crash). 
To fill with a value not available from the keyboard, write that value to the HOT Z variable FILC, 
then use the CLEAR (not FILL) command. 


The LLIST command in WRITE will send the contents of the screen, starting with the cursor line, 
to your 2040 printer. Printing will continue, interrupted by page flips of the display, until the line 
just before the END address. If you forget to set END, you can BREAK to save paper. 


There is also a hex-arithmatic command, which, though not a block command, uses both the cursor 
address and END. The command is READ, and the result is the hex sum and difference (END 
minus cursor address) of the two values, which are displayed in the command (top) line. 
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The Readdress (for jump tables and NAME files) and Relocate (for programs) commands are 
described in a later section of these notes, due to their complexity. 


A detailed description of all the HOT Z commands is also included as a later section intended for 


occasional reference. Other sections will give you details on naming and NAME files, the 
floating-point language interpreter, and the program relocator. 


HOT Z’s Flags 


HOT Z uses the BASIC system variable STRLEN as 16 bit-flags, so you could crash the system if 
you try to load that variable. The meaning of HOT Z’s flags is that they are SET to indicate: 


Bit HZFG (TY+39) STRLEN 
0 Disassembly of RST 08 SP display 
1 Disassembly of RST 28 RST 28 disassembly in progress 
2 An insert Unused 
3 A NAME input Unused 
4 Data display Unused 
5 Hexedit not assembly Assembly in STEP 
6 F-p constants Disassembly of APPX 
7 Window in STEP Transfer of NAMES 


This use does not, to our knowledge, affect the operation of a co- resident BASIC program. 


SINGLE-STEP WINDOW COMMANDS 


Those of you who have used HOT Z on the ZX81 are aware that there was once a second screen 
(called the window from yet an earlier version, when it was only a partial screen) available to 
accept your display manipulations during single-stepping. 


The window commands are not implemented in HOT Z-2068 v. 1.6 and above. There are four 
commands, and they are all called from the single-step display (unlike HOT Z-II). You must first 
have 1B00 (6912 decimal) bytes available for the extra screen. With the high version of HOT 
Z-2068, you might use 8500 to 9FFF, for example, and put your test code above F720. 


The commands are: Key 
WINDOW SETUP ATTR 
WINDOW IN IN 
WINDOW OUT OUT 
WINDOW STOP SCREEN$ (toggle) 
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All of these are commands whose work goes on behind the scenes. The acknowledgment that the 
command has been executed is the same in each case, the appearance of a W near the left end of 
the LAST-NEXT line above the code section of the single-step screen. 


WINDOW SETUP establishes an initial white Screen and will destroy anything you have in the 
selected 1B00 bytes of memory. Set up the beginning byte by entering its address, so that it comes 
up in the bright line of the single stepper. Then give the ATTR command. The SETUP switches 
the window IN and sets the STOP as well. The initial print position is the top left corner, but don’t 
forget to initialize that in your program for the day you expect it to run by itself. 


WINDOW OUT switches the window out of the single step loop but does not destroy it. Any code 
steps you execute after WINDOW OUT will have no effect on the second screen. The point is to 
stop it flashing on every time. 


WINDOW IN countermands OUT and brings back a previously established window. It will not 
function if you have not previously set up a window. However, if you have previously been using 
a window and have reclaimed the space for something else, and if you then use the IN command, 
you may get some strange effects. If there has never been a window, you will not get the "W" 
response. 


WINDOW STOP is a toggle switch. Each time you press it, HOT Z responds with a "W" on the 
LAST-NEXT line. When you initialize a window, the stop is set so that the new screen comes up 
and waits for a keystroke before returning to the register display. If you toggle the stop, the second 
screen will flash on and then get put away without waiting for a keystroke. Toggle again and the 
stop will be reinstalled. The point is to switch out the stop for steps that don’t affect the display. 


There is one sub-command available during the STOP. If you press the V key (CLS), the screen 
will be cleared and you will be re-initialized to a blank screen and your print position reset to top 
left. 


The WINDOW routines respond only to the print position in S_POSN, not to DF_CC. The latter 
is always set from the former via a CALL 0914, on every step. If the window is IN when you 
change S_POSN, then the new screen position will be remembered next time an actual print 
occurs. In fact, you should always use a window when you do things with S_POSN, so that your 
manipulations don’t mess up the single-step screen. 


If you print with RST 10, then you should use the INT (RUN CALL) command to get all the way 
through the RST in one step. In general, the most effective use of the window will occur when you 
set up your display routines as subroutines and run through them in a single step with the INT 
command. Alternately, you can set breakpoints and use the Run-To Breakpoint (THEN) com- 
mand to get through your screen manipulations in one quick dash. 


Note that you can save any screens you are working with by exiting the single step and using the 
HOT Z data save. You will not get a SCREEN type tape from it. (You could set up a block move 
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to screen memory and call that from BASIC along with an in-program SAVE SCREEN$). Then 
for re-use, first set up a new window screen from the single stepper, then exit and load in the data 
tape to the window screen address. 


THE COMMAND SET 


Keying is described as CSS- for the Caps/Symbl-Shift combination before another keystroke and 
SS- for Symbl Shift pressed simultaneously with another key. Keys are referred to by any of the 
three rubrics on the keytop. Mnemonic associations are generally with the letter on the key: for 
example, Assembly is Symbol-Shift/A, the STOP key. Remember that you can reassign any 
command to any key by moving addresses in the command file (CDFI). 


READ Mode 

Key Description 

SS-Q Quit HOT Z for BASIC. HOT Z remains resident and can be recalled with GOTO 
9060 or the RAND USR in 9060. 


CSS-COPY Copies the screen. Useful for small routines. Gives you headings and all. Consider 
using the LLIST command from an edit mode for no headings and variable length. 


SS-E Sets the cursor to the top line and switches to the hex- edit mode. This command 
also works from assembly-edit mode without resetting the cursor line. 


SS-A Sets the cursor to the top line and switches to the assembly-edit mode. The same 
keystrokes will get you from hex-edit to assembly edit. This command works only 
when the disassembly display is on. 


CSS-T Move the display to the ’top’ of the NAME file and switch to the data display. 
(SAVE) Use this command as preparation for SAVing a NAME file. (Turn on the cursor, 
set END, and SAVE.) 


CSS-SS-N NAME file switch. If you are using only one file, the NAMEs are switched off 
(OVER) or on. If you have two files in memory, the command will switch from one file 
to the other. The point of the double NAME file is for revising a program under 


development, so that you can use the same NAMEs at two different addresses. 


CSS-R Restarts HOT Z. Resets the stack to clear clutter. 
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CSS-REM 


CSS-SS- 
INK 
PAPER 


SS-STEP 


SS-GOTO 
(THEN) 


SS-TO 


SS-OR 


SS-<> 


SS-AT 


SS-O 
(PEEK) 


Installs a 1 REM statement in BASIC at the value in the system variable prog 
(normally 6B56H). The-REM will run to the value in END and will push other 
BASIC lines to higher memory. Large REM statements are not compatible 
with low-memory versions of HOT Z because they may overwrite HOT Z. 


BORDER color set. Follow with a color key. 
INK color set. Follow with a color key. 
PAPER color set. Follow with a color key. 


Switch to single-stepper. The address in the NEXT and LAST slots will be last 
ones used there. Use this command to get back after you have spotted and repaired 
an error in the upcoming code. ALL old single-step register values are preserved. 


The display switch from disassembly to data display or back again. The same 
command works with the hex-edit cursor on but not from assembly-edit. 


Enter a value to the END variable, as in EDIT mode 


Indicates decimal address to follow. Clears away the ADDR cursor and waits for 
your entry. If the decimal address is less than five digits long, hit ENTER after the 
last. 


Sets the screen to a continuous SCROLL. BREAK will Stop it. A toy. 


Switches on or off a display of the stack-pointer address in the upper right screen 


corner. The default is Off, because it isn’t pretty, but you should turn it on when 
you are test running your own routines. There is a small amount of shock 


absorption in the HOT Z stack, but if you should see it changing, than look very 
carefully at what you are doing to the stack with the routine you are testing. 
Restarting HOT Z will reset the stack. 


Switch the on-off state of the floating-point dis-assembler. If turned off, then the 
SS-I command will have no effect. If on, then every EF (RST 26) will switch to the 
floating-point disassembly and every 38H will switch off the floating-point 
disassembly. If you have a stray EF on screen while you are in an edit mode, you 
may get a messed up display when you enter code. If so, exit (ENTER) from edit 
mode, use this command, and go back into the active mode without fear. Default 
state is OFF. 
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SS-I 


Floating-point interpreter switch. This is a flag switch (NOT an on-off switch) 
which switches interpretation of a byte from Z80 language to floating-point 
language. This command is necessary for certain embedded sections of 
floating-point code that are not preceded by an RST 26 but are jumped to from 
some other portion of floating-point code. This command will not function if 
the PEEK switch has been set to off. If it doesn’t work, hit PEEK and try again. 


WRITE Mode Commands 


SS-E 


SS-A 


DELETE 


EDIT 


ENTER 


Switch to hex-edit mode from assembly edit. Moves the cursor horizontally. 


Switch to assembly-edit mode. Works only when disassembly display and edit 
mode are on. Moves the cursor horizontally. 


Deletes the instruction at the cursor and closes up the code between the cursor and 
END. END may be either lower or higher than the cursor address. If END is less 
than the cursor address, then code is moved from lower addresses to close the 
spacer if END is greater than the cursor address, then code is moved from higher 
address’s to close the space. Code at the END address and beyond (moving away 
from the cursor) is preserved. If END is 256 or more bytes away from the cursor, 
than you will be asked each time to verify the END value before the command is 
executed. The purpose of this is to prevent your messing up the entire memory by 
forgetting to set END properly. 


Sets the Insert mode for the next instruction (only) to be entered. If END is less 
than the cursor address, then instructions are pushed to lower addresses (up the 
screen) as far as END, if END is greater than the cursor address, then instructions 
are moved to higher addresses (down the screen) as far as END. Any NAMEs 
assigned to shifted memory area will also be shifted so that they stay with the 
instruction to which they were assigned. Relative jumps to or from the shifted area 
are not corrected and may require a fix-up. If END is 256 bytes or more from the 
cursor address, you will be required to confirm the END value before the operation 
proceeds. 


Quit to READ mode when cursor is in "home" column. During hex entry, ENTER 


escapes and leaves the original memory contents intact. During mnemonics entry. 
ENTER sends the line contents to the assembler for entry into memory. 


During mnemonics entry, escapes and leaves the original memory contents intact. 


Page 19 


STEP 


TO 


CSS-F 


CSS-G 


CSS-N 


CSS-X 


ERASE 


Single-steps the instruction at the cursor address and switches to the single-step 
display with the result of that instruction in the register values and the following 
instruction in the NEXT slot. 


Brings up the END? cursor that allows you to reset the END variable. When ever 
a block of code needs to be marked, it is generally delineated by the cursor address 
and the address assigned to END. Always use it to block out a segment of memory 
for Insert and Delete commands before beginning to edit. END should be set 
within 256 bytes of the cursor for editing, but that restriction can be overridden in 


any particular case. (See Insert and Delete instructions). 


FIND the string marked by the cursor (first byte) and END (last byte). Sets the 
display to start with the found string. If no match is found, then the display 
remains at the template string. To find the next match without going back to the 
template, use CSS-G. Do not use other commands between these two. 


FINDs the next successive match to the template string set up by CSS-F. After a. 
match is found, you must move the cursor past the beginning of the matching 
sequence before using this command, to avoid finding the same occurrence again. 


NAME command. This command has two separate effects, depending upon 
whether it is used with the disassembly display or the data display. With the 
disassembly display, the effect is to christen that instruction with the NAME that 
you enter to the screen following the command. A NAME requires four characters 
with at least one beyond F in the alphabet. (all of lower case works). Space and: 
semicolon should not be used. With the data display, the NAME you enter _ 
following the command must already be assigned to some address. HOT Z then 
looks up the address for that NAME and pokes that address to the byte at the cursor 
address and the byte following, then moves the cursor down two bytes. Use this 
form for entering tables of addresses 


Deletes the NAME at the cursor address from the current NAME file. This 
command will only affect the NAME that you see on screen with the disasse 
bly display, so it is best not to use it with the data display. 


Clears memory from cursor address to END. Take care not to erase HOT Z or 
your own programs. 


Fills memory from cursor address to END with the code for a key that you 


specify in response to the KEY? prompt. For unkeyable values, write that value 
to the HOT Z variable FILC and then use the ERASE command. 
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CSS-SAVE 


VERIFY 


CSS-LOAD 


CSS-W 


CSS-T 


CSS-SS-T 
(MERGE) 


CSS-GOTO 


CSS-RUN 


LEN 


LLIST 


SAVEs code from cursor to END. Enter a tape name without quotes. This is a 
CODE-format SAVE. You can reload such tapes from BASIC by converting the 
cursor address to decimal and setting the byte length to END minus cursor address. 
VERIFIES a CODE format tape from cursor to END-1. No quotes on tape name. 


LOAD from cursor to END. Loads 2068 CODE-format tapes. Set the cursor to the 
start address and END one byte beyond the last, such that END minus cursor 
address equals the byte length. Unlike the BASIC command and earlier versions of 
HOT Z, a tape name is always required by this command. No quotes are used. 


LOADs a ZX81 format tape from cursor to END. Uses no tape name and does 
not toggle border color. LOADING appears in top line when active. Takes a 
BREAK. A ZX81 BASIC tape has its end address (counting from 4009H) at 
the 12th and 13th bytes that load in from tape, so do a short load. calculate the 
length, add that to the cursor address and set END. If you set END too high, the 
routine will continue to search and you will have to BREAK. 


Transfers code between the cursor address and END (inclusive) to a destination 
(DEST) that you enter following the command. ENTER after DEST executes 
the command; SPACE after DEST cancels the command. TO after DEST lets 
you reset END before the command is executed. Does not transfer NAMEs. 
To do that, use the MERGE command, which is otherwise identical to this one. 


TRANSFER memory contents and assigned NAMEs from a memory block 
(cursor address to END, inclusive) to an area beginning with an address entered 
in response to the DEST prompt. (See CSS-T command.) 


Display switch, data/disassembly. Works only from hex-edit mode. (THEN key) 


Runs code beginning at the cursor address. Returns to HOT Z with the first RET. 
If you do an extra POP and destroy the return address, then you are on your own. 
(This command differs from the similar one in HOT Z-1, which requires a JP back 
to HOT Z). Recommended procedure is to test your routines first with the single 
stepper before attempting the R command. 


Performs a 32-bit CHECKSUM from cursor address to END and switches to 
the STEP display, where the sum is in BCDE. 


Outputs the screen without headings from the cursor address to END to the 
2040 printer. 
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CSS-A 


AT 


MOVE 


CSS-Y 


CSS-U 


CSS-COPY 


OR 


Does hex arithmetic. Takes the cursor address (h) and END (E) and displays on 
the top line the sum (E+K) and difference (E-K) in hexa-decimal. 


Moves cursor to far left of screen and awaits your entry of an address, then 
disassembles from that address to bottom of screen. Use it for a composite 
listing. Use CSS-COPY immediately after to print the screen display. 


Relocates Z80 code between the cursor address and END. Re-addresses all CALLs 
or JPs, Allows a three way partition of code, variables and (constant) files. 
Requires nine addresses to be first entered at TEMI through TEM9. See the special 


‘instruction sheet on this command. 


READDRESS a jump table (address file) between the cursor address and END 
by a 16-bit displacement value entered in response to the DISA prompt. Takes 
the address (lo-hi order) at each pair of memory locations, adds the 
displacement, and re-enters the sum to the same locations. 


READDRESS that portion of a NAME file between cursor and END by the value 
you enter to DISP. For special file manipulations only. Normally, you should use 
the MERGE command to move NAMEs and code around in memory. 


COPIES screen to 2040 printer. Intended mainly for use with the PARTSCREEN 
command for printing out composite disassembly from separate address blocks. 


Sets END equal to the currant cursor address. 


SINGLE-STEP MODE 


Key 


SS-Q 


ENTER 


SPACE 


EDIT 


Function 

Quit single-step and return to READ. Return address is the address in the NEXT 
slot of the single stepper Register values will be preserved if you re-enter from 
READ mode. 


Runs the instruction in the NEXT slot and reports the resulting register values. 


Skip the step in the NEXT slot and advance to the next instruction. Skipped 
instructions are not listed in the LAST slot at the top of the disassembly segment. 


Backs up. On its first use, this command takes the instruction from the LAST 
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CSS-COPY 


CSS-RUN 


OR 


AT 


SS-GOTO 


VAL 


slot at the top of the disassembly listing and puts it in the NEXT slot (second 
line). Repeated use with no intervening commands will back up one more byte 
for each keypress. Intended use is just to get the last step back. 


Print screen. Copies current screen to the 2040 printer 


Run a CALL or RST 10. It is your responsibility to know that the called routine 
will not crash and not to send RST 10 any unprintable characters. The purpose 
of this command is to shorten the time needed to step through complex routines. 


Set Breakpoint2. Breakpoints are set just as register pair are, with a NAME or 
address entry into the NEXT cursor. You must set the breakpoints precisely to 
the beginning of the instruction at which you want the single-step to stop, 
because the stop depends on the address of the next step being exactly equal to 
the breakpoint. If the breakpoint points to the second byte of a two-or-three-byte 
instruction, you routine will never stop until you crash or hit BREAK. 


Set Breakpoint2. Breakpoints are set just as register pairs are, with a NAME or 
address entry into the NEXT cursor. You must set the breakpoints precisely to 
the beginning of the instruction at which you want the single-step to stop, 
because the stop depends on the address of the next step being exactly equal to 
the breakpoint. If the breakpoint points to the second byte of a two-or-three-byte 
instruction, you routine will never stop until you crash or hit BREAK. 


Display breakpoints. Lists the current setting of the points on the line below the 
flags display. 


Go (run) to breakpoint. Causes the test routine to run from the address in the NEXT 
slot to either of the two breakpoints, which must be set in advance of this command. 
Breakpoints must be set to an address that starts acommand. The GO routine 
checks the BREAK key after executing each line of code, so that you can recover 
from endless loops and sometimes from runaway routines (if your quick) by hitting 
BREAK. 


Set register value. The response to this command will be REG? in the NEXT 
cursor. You should respond as follows for the various registers: 


A forthe A register H for the HL pair 

B for the EC pair S for the user’s Stack Pointer 
D for the DE pair X for the IX pointer 

F for the Flags register Y for the IY pointer 
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Note that all settings are 16 bits (two bytes) except for the one hex byte for A and 
the mnemonic setting for F. The specific flag bits are set or reset with the same 
mnemonics as are reported (M, P, Z, NZ, PO, PE, C, NC). Use this command to set 
up initial conditions for testing your routines. 


SS-A Sets the assembly cursor at the instruction in the NEXT slot so that you can 
EDIT it. Return to STEP operation with ENTER. 


ATTR SETs a second display file (WINDOW) starting at the address in NEXT and 
extending 1B00 bytes. Any stepped display instructions then output to the 
‘window, which comes up before the next register display. Be careful not to 
erase valuable code by setting the window on top of it. 


SCR$ Toggles the feature that causes the WINDOW to wait for a keystroke before going 
to register display. 
OUT Switches the window out of the STEP loop so that subsequent steps have no 


effect on it. 


IN Switches a WINDOW from OUT back IN again. WINDOW must be SET up first. 


ON NAMES AND NAMING 


HOT Z?’s labelling or naming system is intended to make the programs you are reading or writing 
more comprehensible when they are listed. The four-letter limit is imposed by the 32-column 
display. A space is not a legal character in a HOT Z NAME, so use a dash or other punctuation if 
you want fewer than four letters. A semicolon is also illegal, since it is the escape character for the 
assembly editor. 


The NAMEs themselves and the addresses they are assigned to are contained in a special file, 
referred to as the NAME file. A NAME file is an ordered list beginning with the highest address 
to which a NAME is assigned (two bytes), then the four letters of that NAME, then the next highest 
address, etc. After the last NAME in a file, there must be two zero bytes. HOT Z takes care of 
ordering the NAMEs for you. 


A small NAME file is loaded every time HOT Z is loaded, and that file contains four-letter ab- 
breviations of the system variables as well as HOT Z’s variables. You will find a few extras 
among the system variables. LINK, TADD, and ASIM are used by the single stepper. TEMI 
through TEM9 are slots for temporary 16-bit variables for various HOT Z routines. You may use 
them for any of your own routines for values that are not required once the routine is over, pro- 
vided your routine does not call the floating-point calculator. 
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The permanent NAME file that loads with HOT Z can be expanded to hold any NAMEs you add 
in a session of using HOT Z, or you have the option of starting a new file from scratch. In the 
standard version, the permanent NAME file is located just above a large work area, and as you add 
NAMEs the file expands downwards in memory (to lower addresses). 


Add a NAME to the file with the CSS-N command in WRITE mode with disassembly (not data) 
on screen. The command will give you a cursor in the NAME column and allow you to enter or 
replace the NAME for that address, (a legal NAME is made up of only four single characters with 
the restriction that at least one character must be beyond F in the alphabet. If you forget that rule 
HOT Z will refuse to accept your new NAME and will ask you for another. A space in a NAME 
will be accepted and the disassembler will list the NAME, but you will not be able to use such 
NAMEs when working with the assembler, which parses according to spaces and punctuation. 
Take care that your NAMEs are unique, or HOT Z will always find only the one at the higher 
address when you refer to it. If you enter a NAME to the ADDR cursor before you assign it, then 
the NAME file will be searched and the display will move to that NAME if it is already there, 
otherwise the display stays put. 


The CSS-X key (WRITE) will delete a NAME at the cursor address from the screen and from the 
NAME file. 


The CSS-T command (READ) is there to let you find the start of your current NAME file. You 
may want to check up on it if you are working under crowded memory conditions to be sure the 
file doesn’t overwrite some valuable code. This command switches the display to data and moves 
to the lowest address of the NAME file. Since the NAME column in the data display lists NAMEs 
assigned to addresses formed by pairs of bytes in the hex column. The NAME appears horizon- 
tally across from the first address byte and then vertically opposite the last four data bytes. Be 
aware that chance occurrences of data can look like addresses and cause spurious listings in the 
NAME column of the data display. 


You should also use the CSS-T command when it comes time to SAVE the NAMEs you have 
entered in a session. However, you will also need to know the end address of your file in order to 
SAVE it. You can call up that end address by entering NEND to the ADDR cursor; the end 
address of the NAME file is listed lo-hi there. You can either add 2 to that address to include the 
two zero bytes that act as a terminator, or you can remember to zero those two bytes after you 
reload the tape. If you choose the first option, hit RND, turn on the edit cursor, set END to 
NEND+2, and SAVE. Record the addresses for use when you reload. 


When you reload a NAME file, you must install the start and end addresses so that HOT Z will 
know where to look for that file. This is done at the four-byte block labelled ALNA (alternate 
NAMEs). With the data display and the edit mode, write the start address twice (lo-hi) followed 
by the NEND address; don’t forget to subtract 2 if you have included the terminating zeroes. If 
you have not included them, make sure they are there first. If you don’t do these settings correctly, 
you will hang up the program when you try to switch the new file on. 
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The NAME-file switch command is OVER in READ. It will switch from the permanent NAME 
file to the one you have loaded, after you have installed the file parameters at ALNA. If you use 
OVER without installing the new parameters, the effect will be to switch off the NAMEs entirely 
and you will not be able to add new ones. You should switch off the permanent NAME file in this 
way before loading a new file; then install the start and end addresses of the new file at ALNA and 
use OVER to switch them in. 


A large NAME file is included on your master tape to give you some idea of the main HOT Z 
routines. An annotation of the labelled routines plus a tape of labels for the ROM and an annota- 
tion for that (plus the EXROM and RAM-resident code) is available from Sinware for $17 ppd. 


If you save HOT Z using the BASIC routine on the master tape, then your current label file will be 
saved along with HOT Z and will load again from the same tape. Thus you can pick up on a given 
project without creating a separate NAME file. 


You can amalgamate NAME files only if they pertain to separate blocks of memory, with the 
addresses in one block all higher than those in the other. Then just load the two files end to end in 
the proper order and save them as a single file. 


To start a completely new file, put the starting/ending address (the same, because it’s empty) in the 
four bytes at ALNA and give the OVER command, then enter NAMEs. 


You can SAVE a NAME file as data, then LOAD it in and hook it up by writing the starting and 
ending address at ALNA and using OVER. Always remember that there must be two zero bytes 
above the value you assign to the high end of the file. 
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SOME IMPORTANT HOT Z NAMES 


AFEX 
AFRG 
ALNA 
ASIM 
BCEX 
BCRG 
BPT1 
BPT2 
CADR 
CBFL 
CHOO 
COUN 
DEEX 
DERG 
EDDQ 
EOPA 
FCBQ 
FENS 
FILC 
HLEX 
HLRG 
IXRG 


Store for AF’ register pair in single-stepper 
Store for AF register pair in single-stepper 
Alternate NAME file descriptors- Six bytes 
Single-step simulation area. Five bytes 

Store for BC’ register pair in single-stepper 
Store for BC register pair in single-stepper 
Breakpoint #1 address 

Breakpoint #2 address 

Current address for disassembly 

Flag for a bit-op prefix (CB) 

Selects and updates Read mode display 
Counter for printing register values 

Store for DE’ register pair in single-stepper 
Store for DE register pair in single-stepper 
Flag for ED prefix 

The END address 

Flag for prefixed bit ops 

Single-step window switch; holds CRUN if off 
Fill character, normally zero for screen clear 
Store for HL’ register pair in single-stepper 
Store for HL register pair in single-stepper 
Store for IX register pair in single-stepper 
Store for IY register pair in single-stepper 
address pointed to by the cursor 

Gets code of keystroke into A; preserves other regs 
Line number with cursor 

Screen address of the cursor 

Puts cursor address into HL and KADD 
Length of current instruction in disassembly 
Stores address for floating-point interpreter 
Last one-step instruction 

Next address for disassembly 

Switch for NAME lookup 

End of NAME list 

Next one-step instruction 

Most recent leading (low) address of NAME file 
One-step display file for extra window 
One-step display point for window, as DFCP 
Overflow warning for User’s stack 
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POIN Pointer used in building register-value display 
PRIM Space or prime for register display 

SPBI Stack-pointer storage bin for stack switches 
UNDR Underflow warning for User’s stack 

USRS _Single-step user’s stack pointer. Sets with S. 
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USING THE RELOCATE COMMANDS (MOVE, STR$, CHR$) 


The Relocate command is rather complex in order to provide you a degree of flexibility in relo- 
cating your routines. A set of nine addresses must be entered before using the MOVE command, 
and a certain amount of planning and knowledge of the subject program is required to derive the 
correct addresses. Simple programs with one or too calls or absolute jumps are best labelled, 
moved with the Transfer-with-NAMEs (MERGE) command, and then fixed up by hand. 


A program of reasonably complexity will have a block of code, a block of data (which may include 
address lists or jump tables), and a block of variables. Good programming form could recommend 
that you keep these blocks separate and distinct rather than, say, mingle data and variable storage 
in the crannies between your subroutines. If you are programming with HOT Z, you can separate 
the blocks generously as you develop your program and then use the Relocate command to close 
the gaps when you finish. 


HOT Z’s Relocate command will work on program blocks where code, data and variables are 
separate and distinct. If you have embedded patches of data, the command may still work, but you 
should check the data after the relocation to make sure that it has not been changed under the guise 
of re-addressing code. Programs such as the 2068 ROM, where jump tables lie around like empty 
beer cans, would have to be broken up into segments and relocated piecemeal. 


The Relocate routine re-addresses and moves Z80 code. However, the command does not take 
account of overlapping segments between source and destination blocks, so you cannot directly 
relocate a program to addresses already occupied by that program. In such cases, you should use 
the transfer command first and then readdress in place with the relocate command. 


Jump tables have to be revised with the CSS-Y command, which first asks you for a displacement 
and then adds that displacement to each address in the file, starting at the cursor and ending at the 
END address. If you moved your code from 8100H to 8400H then the displacement would be 
0300H; from 8400H to 8105H would be a displacement of FDOOH. Jump tables and data blocks 
should be moved with the Transfer command prior to using the relocate command. 


The Relocate command (MOVE) allows you to move the code block by one displacement, the data 
block by another, and the variables block by a third displacement. Any other three-way separation 
should also work. 


ADDRESS ENTRY FOR RELOCATING 


The variables TEM! through TEM9 are used to set the nine address parameters for relocation. The 
nine addresses are three sets of three addresses. Each set of three addresses indicates the start and 
end of an address range to be changed and the start address of the new address range. For example, 
suppose your program to be relocated fits the following memory map: 
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84D0-84E8 Variables 
64F0-84FF Data 
8500-86BO Program 


Suppose you want to put the variables and data at 8100H and the program at AC40. First, transfer 
the variables block to 8100H, it will run to 8118, so transfer the data block to 8119-8128. To move 
the program from 8500 up to AC40, any addresses of jumps or calls that lie between 8500 and 
8660 should be changed to lie between AC40 and ADCO. You don’t need that last number. So 
enter the original range in TEM1 and TEM2 and the first address of the new block in TEM3, thus: 


TEM 1 - 6600, TEM2 - A680, TEM3 - AC40 


These first three TEM values always hold the parameters relating to the program (code) block. 
Variables and data parameters can go inter-changeably into TEM4-TEM6 or TEM7-TEM9. 


Addresses of variables, which were at 84D0-84E8, must be changed to start at 8100, and addressés’ 
of data, formerly at 84F0-84FF, must be changed to begin at 8119, so fill in the remaining TEM 
slots as follows: 


Variables Data 

TEM4 84D0 TEM7 84F0 
TEMS5 84E8 TEM8 84FF 
TEM6 8100 TEM9 8119 


TEM4-6 are one block, TEM7-9 the other. Now set the cursor at 8500 (start of the code segment) 
and set END to 8680, then give the MOVE command. The code will be copied to the new location 
and readdressed to run with the new variables, new data block, and any relocated subroutines in 
the code block. The original code will remain unchanged at its original location. 


You may also use the Relocate command to split a code block into two or more separate blocks, 
but you must apply it repeatedly, once for each of the end-product blocks, and readdress for the 
blocks that are not being moved as if those blocks were variables or data. 


If you lack variables or data blocks, then use a single non-zero dummy value for all three of the 
second or third set of TEM values. i-e., make them all three the same. 


The relocator leaves unchanged any ROM calls or any loads to or from the systems variables area 
(5C00-6000). 


After You have relocated a program, you may want to readdress a block of NAMEs that pertain to 
it. The command on the CHR$ key will do this for you. The CHR$ command works just like the 
STR$ command, except that it readdresses every third pair of bytes. Just enter the proper 
displacement. If you are re-addressing only part of a label file, you may have to do some block 
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moves to keep all the addresses in inverse sequence. Labels will be lost (from the screen, not the 
file) if you destroy the ordering of the addresses. 


RELOCATING HOT Z-2068 


Here is a blow-by-blow account of a relocation of the current high version (1.61) of HOT Z. I 
assume you have read the generalities above first. Remember that relocating small routines is 
much much easier, so don’t let the complexity of this exercise put you off. You might want to read 
the chronicle just for some examples of how to use the various commands and to manipulate label 
files. 


I decided to start the low version at 6C00, which is just high enough to avoid entanglement with 
the BASIC system and to allow another 2-300 bytes in BASIC if needed. It would not be impos- 
sible to put HOT Z into a REM, but that seems a very messy arrangement. Since HOT Z runs from 
C000 to F720, its length is 3720 and the low version will extend from 6C00 to A320. The CSS-T 
command tells me that the large NAME file extends to A018, so there would be an overlap. To 
avoid that, I removed the ROM labels, which can be restored later. 


To remove the ROM labels, I searched for the NAME prbf, which is the lowest NAME in RAM, 
and found that ending at B433. That meant the length of my shortened NAME file would be 141C 
(B434 - A018). Since the actual names extend down from BF6E (allowing for the two bytes of 
zeroes at 6E and 6F), the shortened NAME file would begin at AB52. I then turned off the NAME 
file with CSS-SS-N (OVER) to avoid confusing it during the manipulation. Next, I set the cursor 
at A018, set END to B433, and gave the CSS-T (simple transfer) command, setting DEST to 
AB52. After that I double checked the high end of the file to see that it did indeed end with prbf 
and the two zeroes just before BF70. Then I installed the new file beginning address at BFE2 
(ALNA when the NAMEs are on), writing in 52 and AB with hexedit. Then I switched the 
NAMEs back on with CSS-SS-N. The CSS-T command in READ can be used to verify the new 
beginning of the NAME file. 


The reason for all this manipulation was so that I could get a fully labelled relocated version. To 
reassign the labels. I used the Transfer-with-NAMEs command (CSS-SS-T or MERGE) to move 
the entire program (CO00-F720) to 6C00. I set the cursor at C000, set END to F720 and gave the 
command, which takes some time to revise all those NAMEs. The result is a labeled copy of HOT 
Z at 6C00, but the addresses have not been revised; it is not a relocation. This step was just to get 
a new label file. 


The actual relocation requires use of the Relocate command on the MOVE key in EDIT mode. 
That command requires setting up the TEM variables, as described above. Since I wanted to move 
the code and the data segments by the same displacement. I set the first three as: 
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TEM! C000 Start of block 
TEM2 F71F End of block 
TEM3 6C00 Start of relocated block 


If I had wanted to move the data block by a different displacement from the one I used for the code. 
For example to put the data first and then the code. I would have needed to set values for the next 
three TEMs, but in this case I could just dummy them with an address that is out of the range of 
the program. I set them each to F720. 


It did not make sense to leave the variables hanging at EF70 thouyh, so I decided to put them just 
above the program at A320. To do that I set the last three TEMs as: 


TEM7 BF70 Start of variables 
TEM8 BFFF End of variables 
TEM9 A320 Start of new variables 


I did these settings with hexedit on the data display and then switched to disassembly, where the 
TEM labels are, to double check that all addresses were in lo-hi order. 


Next, I set the cursor to C000, set END to ED9F (the end of the code segment, not the entire block, 
because I don’t want to readdress what might appear to be JPs and CALLs in the data), and gave 
the MOVE command. Then I went to look at a familiar part of the new code (STAR) to check that 
the CALLs and JP’s there did indeed reference the new NAMEs. I noticed then that I had forgot 
to move the variable NAMEs. 


This required another use of the Transfer with NAMEs command. Set the cursor to BF70, set 
END to BFFF, give the CSS-SS-T command, set DEST to A320 and hit ENTER. 


After that, the code around STAR looked good, properly labeled. The advantage of having done 
the work to revise the label file in advance is that it serves as a check at this point. If something 
had gone wrong with the relocation, then the CALLs and JPs would not consistently reference 
labels. 


Now to revise the jump tables so that the new version’s commands will jump to its own code and 
not that of the original version. To calculate the displacement, I used the Hex arithmetic command 
and set the cursor to C000, the original code start, set END to 6C00, the new code start, and 
pressed READ. The displacement is the difference, ACOO, neglecting the carry or borrow. 


I happened to know that the first jump address actually begins at MNAD, so I could just punch in 
the NAME rather than compute the new location from offsets. The last jump address is at A303, 
so I set END to that. Than I used the Readdress command on STR$, with ACOO as the 
displacement. I had the data display on, and the NAME column came up with a full list of jump 
destination labels as the command did its work. 
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At this point, I should have been finished and ready to save and run, but I have learned that a 
couple of fix-ups are necessary. The jump tables contain one address that should actually be 
constant and not displaced. That address is ASIM, the single step workspace, and it occurs be- 
tween RSTD and SRET at A162. I fixed that up in data mode with the CSS-N by entering ASIM 
to the NAME column. There are also two addresses in the variable-initialization file, IVAR, 
which needs a displacement. I went to IVAR and wrote in the proper first address, which is CRUN 
at 9FCE, and at 9FF8 I installed a new value for the STEP user’s stack pointer by putting in A340. 
That value can be anywhere safe but it is designed to be between OVER and UNDR. 


The variable initialization file also sets the addresses at which HOT Z will look for its NAME file, 
and these have to be changed for the new file. At this point, I installed AB52 at A026 and A028. 
(BF6E was still there at AO2A because I had not moved that end of the file. I changed these again 
later when I reinstalled the ROM NAMES.) 


I have also discovered two examples of what is perhaps sloppy programming for relocation and 
which require fix ups. In MCAL and MJPC. I wanted two constants in the register pair DE. I 
should have spent the extra byte and done two B-bit loads. LD D,NN and LD E,MM, but instead 
I used a 16-bit LD DE,NNMM, and the relocator cannot distinguish that from an address if 
NNMM happens to fall into its address range. So I had to get into assembly edit and change the 
first instruction of MJPC back to LD DE,C2C3 (at 912C) and the first instruction of MCAL to LD 
DE,C4CD (at 9160). If you relocated from this version to another location, this fixup would not 
be necessary because these constants would not look like program addresses. 


At this point, I did a data SAVE with HOT Z from 6C00 to BF70 to preserve my work just in case, 
prior to fixing up the BASIC loader. Before I went to BASIC, I noted the decimal values of 6C00 
STAR, and BF70. The high version 1.6 has its BASIC set to peak out the lowest extant of the 
NAME file and to record upward from there. This new version 1.7 has its file above the code, so 
I decided just to record a fixed length every time. That makes lines 9015 to 9020 unnecessary. 
Rather than change line 9050, I just assigned numeric values to PST and FLEN and changed the 
USR in 9060 to call STAR. Then a RUN SAVEd this version and created a self-starting tape. 


Following these maneuvers, I picked off the ROM labels that I had erased from this version and 
reinstalled them by patching them to the existing list. In order to make space for them, I had to 
move the high end of the NAME list to C470. Then I shortened the list to bare essentials and 
installed that from A54A to A900. This actually leaves a bit more space for adding labels than 
does the fully annotated version, but with either of the 1.7 versions you should keep your eye on 
the descending edge of the NAME file (with CSS-T) to make sure it does not overwrite A31F or 
below and cause a crash. 


I hope this example is of some value to some of you, if only as a lesson in how to use the various 
Transfer and Relocate commands. 
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Appendix A 


THE FLOATING-POINT INTERPRETER 


RST 28H is the entry into the ROM’s floating-point operations, which are coded in the bytes 
between an RST 28 and the following 38H. There is a good explanation of this second language 
(Or is it third?) of the ZX in Dr Logan’s article in SYNC 2, 2. (But beware of the two sign tests, 
which aren’t jumps, as labelled in SYNC.) Note also that there have been a few changes for the 
2068 ROM. 


HOT Z will read this floating-point language, but only after you turn on the floating-point inter- 
preter (CSS-O in READ). If you leave the floating-point interpreter turned on, you will get a true 
reading of the ROM, but problems can arise elsewhere in memory when you encounter an EF that 
functions as data rather than a RST 28. You may get locked into the floating-point interpreter 
mode, without a 38H, the END character, in sight. The way out from this barrage of gibberish is- 
the CSS-O command again, which switches out the floating-point interpreter entirely. Other times 
you may want to read it, because this extra language is really one of the treats of the Sinclair- 
calculator heritage. 


The f-p interpreter is also turned off by entry of a numerical address, but not by a page flip or a 
NAME, so use the last two when you’re working with f-p. In addition, there is a special key 
command, CSS-I in READ mode, which switches the flag that tells the disassembler which lan- 
guage it’s in. 


The CSS-I command (READ) has a dual purpose. It will get you out of floating-point mode 
(without turning off the interpreter) if you need to and can’t, or it will get you in when you want to 
be but aren’t. You may get stuck in that mode through addressing yourself into the middle of a 
Z80 instruction, for example. Since floating- point operations include jumps and loops, there are 
also inclusions of f-p code that do not begin with an RST 28, branches of jumps. The CSS-I 
command will get you into those branches. However, the command is just a bit switch and it 
doesn’t function when the screen page itself switches from one language at the top to the other at 
the bottom. The cure, when the CSS-I command doesn’t function is the trick of hitting the THEN 
key twice. This picks up the language mode from the bottom of the page to the top and reverses 
the reading of any bytes from one language to the other. 


You will also encounter some queer behavior if there is f-p code at the bottom of the screen and 
you try to write or go to the One-Step. This is not generally fatal and can be cured by going back 
to disassembly and setting the screen so that it ends in Z80 disassembly. If you want to write f-p 
code, the only manageable way is to go into EDIT mode in data. 


Floating-point operations are FORTH-like ‘stack manipulations and easy to follow if you know 
something about that language. They use the MEM area of the systems variables as storage slots 
for six floating-point numbers. (Each is five bytes.) The f-p operations that transfer between the 
calculator stack and MEM are called GET and STOR and are followed by a single digit from 0 to 
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5 to indicate the slot used. Numbers or letters higher than 5 generally indicate a patch of nonsense 
with GET, STOR and STAK as well. 


Many of the possible f-p operators do not occur in the coding of the ROM, where you are likely to 
encounter them with HOT Z. They occur instead during the ROM’s reading of BASIC programs, 
and they are generally identical with a BASIC instruction. You could learn to write floating-point 
code with these and the purely machine-code f-p operators if you wanted to; it could be similar to 
BASIC and a little faster. The entry point of these BASIC f-p operators into the real machine 
world is through the operation labelled RAFP (Run A as Floating-Point). However, you need only 
use the command numbers listed as the first column of the instruction list to perform those BASIC 
functions on whatever floating-point numbers are on the calculator stack. From the perspective of 
a HOT Z user, RAFP would be used only to run an operation that resulted from some calculation 
whose result was a code in A. 


Two of the f-p operations deliver data directly from the code listing to the calculator stack. They 
generally do this in an efficient way, using fewer than five bytes, if possible, to encode the five- 
byte floating-point number. HOT Z prints the encoded floating-point number in the NAME and 
mnemonics columns of the disassembly listing. Since the interpreter doesn’t know where any 
number will end, it is necessary to begin all of them slightly out of column, or the longest would 
run into the next line and mess up the display file. The f-p interpreter also reads the full five hex 
bytes that go onto the f-p stack, rather than the condensed version that actually occurs in the ROM. 
The ADDR column keeps accurate track, and you can work out the extra bytes, which are gener- 
ally trailing zeroes, from that column. 


HOT Z prints floating-point data by using the same ROM routines that handle that data, so the 
disassembly slows down and becomes jerky when it has to print those huge numbers, or their 
single-digit versions. 


The two data-stacking operations are labelled STFP (stack floating point) and APPX (approxima- 
tor). The first of these puts one five- byte number on the calculator stack, the second a series of 
one to 31 (whatever is left when you AND the low nibble of the instruction byte with OF) five-byte 
f-p constants. (That’s 5 to 155 bytes.) The approximator uses anything from six to a dozen floating 
point constants to get to a value for Chebyshev polynomials to approximate the transcendental 
BASIC functions. 
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FLOATING POINT OPERATIONS 


Op 
JRT 
SWOP 
DROP 


Addr 
3AAA 
37FB 
3760 
33CE 
3489 
356E 
3C6C 
3936 
393F 
3956 
3956 
3956 
3956 
3956 
3956 
33D3 
3948 
3956 
3956 
3956 
3956 
3956 
3956 
39B7 
39F9 
38D7 
3A60 
382D 
3A84 
39F9 
3A8F 
3BD0 
3BC5 
3BF5 
3C4E 
3C5E 
3BFD 
3B2E 


Description 

Jumps if stack top holds a true 

Exchanges the top and second 5-byte stack entry 

Throws away top stack entry 

Subtracts top stack from second stack entry 

Multiplies top two stack entries and leaves product on stack 
Divides second entry by top stack, leaves quotient on stack 
Raises 2nd on stack to power of stack top 

Performs BASIC OR on two top stack entries and leaves result 
Performs BASIC AND on two top stack entries, leaves result 
Numeric inequality test 

Numeric inequality test 

Numeric inequality test 

Numeric inequality test 

Numeric inequality test 

Numeric inequality test 

Adds two top stack entries and leaves sum on stack 

ANDs a string with a number 

String inequality test 

String inequality test 

String inequality test 

String inequality test 

String inequality test 

String inequality test 

Concatenates strings addressed by the two top stack entries 
BASIC function 

BASIC function 

Read in data from channel in A 

Changes the sign of top slack entry 

Replaces top stack entry with its sinclair code 

BASIC Function l 

BASIC Function 

BASIC Function 

BASIC Function 

BASIC Function 

BASIC Function 

BASIC Function 

BASIC Function 

BASIC Function 


Page 36 


26 
27 
28 
29 
2A 
2B 
2C 
2D 
2E 
2F 
30 
31 
32 
33 
34 
33 
36 
37 
38 
39 
3A 
3B 
3C 
80 
AO 
CO 
EO 


3ADF 
3ACA 
3C65 
3851 
3829 
386B 
3864 
3872 
3A3A 
39E4 
391C 
377F 
3ABB 
3AA1 
3785 
3A95 
3921 
3914 
3AB6 
3B9E 
35D3 
3761 
310D 
3808 
37DA 
37EC 
37CE 


BASIC Function 
BASIC Function 
BASIC Function 
BASIC Function 
BASIC Function 
BASIC Function 
BASIC Function 
BASIC Function 
BASIC Function 
BASIC Function 
BASIC Function 
Duplicates top of stack (5 bates) 


Replaces number pair by quotient on stack top, remainder below 


Unconditional relative jump 

Composes and stacks number from following data bytes 
Loop jump as DJNZ with BERG as counter 

Tests sign of stack top and replaces with true if negative 
Tests sign of stack top and replaces with true if positive 
Ends a RST 28 routine 

Adjusts angle values modulo 2 Pi for trig functions 
Rounds down to integer 

Runs byte in A as f-p op code for BASIC functions 
Decimal exponent processor 

Successive approximator: stacks and processes constants 
Stacks 0, 1, 2, 0.5, PI/2, or 10, depending on second nibble 
Stores entry in calculator MEM slot given by 2nd nibble 
Recalls stored entry from calculator MEM slot in 2nd nibble 
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HOT Z-2068 COMMAND LIST -- EDIT MODE 


COMMAND 


SS-D 

SS-F 
CSS-F 
CSS-G 
CSS-N 
CSS-X 
CSS-SS-7 
CSS-SS-2 
CSS-SAVE 
SS-CSS-R 
CSS-LOAD 
CSS-W 


CSS-T 
CSS-SS-T 
SS-G 
CSS-RUN 
CSS-K 
CSS-V 
CSS-COPY 
CSS-A 
SS-I 
CSS-SS-6 


CSS-Y 
CSS-U 
SS-OR 
CSS-H 


FUNCTION 


ESCAPE during assembly edit 
Cursor to HEXEDIT column 


ROUTINE 


SWTE 


Move cursor to ASSEMBLY-edit column SWAS 


ESCAPE during hex edit, or return to 
READ mode from home column 
Single-STEP instruction at cursor 


Set END 


FIND first matching byte sequence 
FIND NEXT matching byte sequence 
NAME entry (disassembly or data) 
DELETE NAME 

CLEAR memory from cursor to END 
FILL memory with key code 

SAVE cursor to END in DATA format 
VERIFY a code-format tape 

LOAD (DATA) from cursor to END 
LOAD ZX81 data data tape, cursor to 


END 


TRANSFER cursor-END to DEST 
TRANSFER code and labels to DEST 
SWITCH DISPLAY (disassemblly/data) 
RUN from cursor to first RET 
CHECKSUM to BCDE in single step 
LIST cursot to END on 2040 printer 
COPY screen to 2040 
Hex ARITHMATIC (E+K & E- K) 
PART screen (enter address) 
RELOCATE code, cursor to END 
(Set TEMs) . 


OSCO 
SEOP 
MATS 
FIAG 
NENT 
DENA 
CLMM 
FLMM 
SV68 
VERI 
LD68 


LD81 
TRAN 
TRNA 
SWDD 
RUNT 
CSUM 
DLIS 
PRWS 
HARI 
PSCR 


RELO 


READDRESS jump table (displacement) RADD 
READDRESS NAME file (displacement) RANA 


Set END = cursor address 
Help screen (v. 1.61) 


KTOE 
HELE 


HOT Z-2068 COMMAND LIST -- READ MODE 


COMMAND 
KEY 


SPACE 
SS-Q 
CSS-COPY 
SS-E 
SS-A 
CSS-T 
CSS-SS-N 
CSS-R 
CSS-REM 
CSS-SS-BORDR 
CSS-SS-X 
CSS-SS-C 
SS-D 
SS-G 
SS-F 
SS-U 
SS-W 
SS-I 
CSS-O 
CSS-I 
CSS-H 


CODE 
SQR 


FUNCTION 


PAGE flip 

QUIT TO BASIC (SIGN OFF) 
COPY screen to 2040 

Turn on HEXEDIT mode 

Turn on ASSEMBLY mode 
Display TOP NAME of list 
Switch NAME files 

RESTART HOT Z (Reinitialize) 
Make REM from PROG to END 
Set BORDER color (0-7) 

Set INK color (0-7) 

Set PAPER color (0-7) 

Go to single STEP 

Switch disassembly/data displays 
Set END address 

DECIMAL address to follow 


SCROLL display (BREAK to STOP) 
Display STACK POINTER (switch) 


Switch f-p interpreter IN/OUT 
Switch f-p INTERPRETATION 
HELP screen (v. 1.61 only) 


ROUTINE 


HOT Z-2068 COMMAND LIST -- SINGLE-STEP MODE 


SS-Q <= QUIT to READ mode 
ENTER ENTER STEP one instruction 
SPACE SPACE SKIP next instruction 
CS-1 EDIT BACK one instruction (or byte 
if repeated) 

SS-COPY LN COPY to 2040 printer PRSC 
CSS-RUN INT RUN CALL Or RST 10 RCAL 
SS-I AT Set BREAKPOINT #1 >- SBP1 
SS-U OR Set BREAKPOINT #2 SPB2 
SS-Y AND DISPLAY Breakpoints SHBP 
SS-G THEN GO (run) to breakpoint RTBP 
CSS-LOAD VAL LOAD register (A, B, D, F, H, S, X, Y) OSRS 
SS-A STOP ASSEMBLE NEXT OSAS 
CSS-SS-L ATTR Window SETUP at NEXT address 

(1B00 bytes) © WISU 
CSS-SS-K SCREEN Window STOP Switch WISW 
CSS-SS-O OUT Switch window out temporarily SWOU 
CSS-SS-I IN Switch window in again SWIN 
CSS-H SQR HELP screen (v. 1.61 only) HELS 


BRERA EKER KEE RARE ERE EERE AEE RARE KKK E E E E E E E E E E E KERR EERE RARE K 
STEP comand addresses are in a file at CDFI, followed by READ command addresses, followed 

by EDIT addresses, Dead keys are marked DeAD in STEP and READ and KRES in EDIT. 
Command address’s are in keycode order from RND through RESTORE, repeating for each mode. 
Presence of an address assigns that routine to that key. Move them or add to them to suit your needs. 
Apendix B of 2068 manual gives keycode order. 


INDEX OF COMMAND REFERENCES 


READ COMMANDS 
SPACE SPACE 
SS-Q <= 
CSS-COPY LN 
SS-E >= 
SS-A STOP 
CSS-T RND 
CSS-SS-N OVER 
CSS-R INT 
CSS-REM TAN 
CSS-SS-BORDR BRIGHT 
CSS-SS-X INK 
CSS-SS-C PAPER 
SS-D STEP 
SS-G THEN 
SS-F TO 
SS-U OR 
SS-W <> 
SS-I AT 
CSS-O PEEK 
CSS-I CODE 
CSS-H SQR 


SINGLE-STEP COMMANDS 


SS-Q 
ENTER 
SPACE 
CS-1 
SS-COPY 
CSS-RUN 
SS-I 

SS-U 
SS-Y 
SS-G 
CSS-LOAD 
SS-A 
CSS-SS-L 
CSS-SS-K 
CSS-SS-O 
CSS-SS-I 
CSS-H 


<= 


PAGE flip 

QUIT TO BASIC 

COPY screen to 2040 

Turn on HEXEDIT mode 
Turn on ASSEMBLY mode 
Display TOP NAME of list 
Switch NAME files 
RESTART HOT Z 


Make REM from PROG to END 


Set BORDER color (0-7) 
Set INK color (0-7) 

Set PAPER color (0-7) 

Got, single STEP 

Switch disassembly/data 

Set END address 
DECIMAL address to follow 
SCROLL display 

Display STACK POINTER 
Switch fp interpreter 

Switch INTERPRETATION 
HELP screen (v. 1.61) 


QUIT to READ mode 
STEP one instruction 
SKIP next instruction 
BACK one instruction 
COPY to 2040 printer 
RUN CALL Or RST 10 
Set BREAKPOINT #1 
Set BREAKPOINT #2 
DISPLAY Breakpoints 
GO (run) to breakpoint 
LOAD register 
ASSEMBLE NEXT 
Window SETUP at NEXT 
Window STOP Switch 
Switch window out 
Switch window in again 
HELP screen (v. 1.61) 


4,17, 25 
17, 26, 31 
17 

18 

4, 18 
4,18 

4, 18 

5, 18 
4,18 

18 

5, 18 

18 

18 

5, 18, 33 
5, 19, 33 
7,8 
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6, 22 
6, 22 
7,22 
22 

23 

23 
7,23 
123 
6, 18 
6, 18 
18 

8, 24 
15, 24 
16, 24 
15, 24 
15, 24 
6, 8 


INDEX OF COMMAND REFERENCES 


EDIT MODE 


SS-O 
SS-E 
SS-A 
ENTER 


SS-D 

SS-F 
CSS-F 
CSS-G 
CSS-N 
CSS-X 
CSS-SS-7 
CSS-SS-2 
CSS-SAVE 
SS-CSS-R 
CSS-LOAD 
CSS-W 
CSS-T 
CSS-SS-T 
SS-G 
CSS-RUN 
CSS-K 
CSS-V 
CSS-COPY 
CSS-A 
SS-I 
CSS-SS-6 
CSS-Y 
CSS-U 
SS-OR 
CSS-H 


ESCAPE during assembly 


Cursor to HEXEDIT column 
Move cursor to ASSEMBLY 
ESCAPE during hex edit, or return to 


READ mode 
Single-STEP instruction 
Set END 

FIND first match 

FIND NEXT match 
NAME entry 

DELETE NAME 
CLEAR memory 

FILL memory 


LOAD (DATA) 

LOAD ZX81 data 
TRANSFER to DEST 
TRANSFER with labels 
SWITCH DISPLAY 
RUN to first RET 
CHECKSUM to BCDE 
LIST on 2040 printer 
COPY screen to 2040 
HexARITHMATIC 
PART screen 
RELOCATE code 
READDRESS jump table 
READDRESS NAME file 
Set END = cursor address 
Help screen (v. 1.61) 
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19 
1513519 
8, 13 19 
8, 19 


13, 20 

12, 20 

14, 23 

14, 23 

9, 13, 20, 25 
13;20, 25 


13, 14, 21, 31 
14, 21, 31 


13, 14, 21 

22 

14, 22, 32 

22 

13, 22, 29, 31 
13, 22, 29, 32 
13, 22, 30 

12, 22 

7 


